/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libdbm.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 64 62 6d 7d 7d | 0d 5c 62 69 6d 6f 64 69 |de{dbm}}|.\bimodi|
|00000030| 6e 64 65 78 7b 64 62 6d | 7d 0d 0d 44 62 6d 20 70 |ndex{dbm|}..Dbm p|
|00000040| 72 6f 76 69 64 65 73 20 | 70 79 74 68 6f 6e 20 70 |rovides |python p|
|00000050| 72 6f 67 72 61 6d 73 20 | 77 69 74 68 20 61 6e 20 |rograms |with an |
|00000060| 69 6e 74 65 72 66 61 63 | 65 20 74 6f 20 74 68 65 |interfac|e to the|
|00000070| 20 75 6e 69 78 20 5c 63 | 6f 64 65 7b 6e 64 62 6d | unix \c|ode{ndbm|
|00000080| 7d 0d 64 61 74 61 62 61 | 73 65 20 6c 69 62 72 61 |}.databa|se libra|
|00000090| 72 79 2e 20 20 44 62 6d | 20 6f 62 6a 65 63 74 73 |ry.  Dbm| objects|
|000000a0| 20 61 72 65 20 6f 66 20 | 74 68 65 20 6d 61 70 70 | are of |the mapp|
|000000b0| 69 6e 67 20 74 79 70 65 | 2c 20 73 6f 20 74 68 65 |ing type|, so the|
|000000c0| 79 20 63 61 6e 20 62 65 | 0d 68 61 6e 64 6c 65 64 |y can be|.handled|
|000000d0| 20 6a 75 73 74 20 6c 69 | 6b 65 20 6f 62 6a 65 63 | just li|ke objec|
|000000e0| 74 73 20 6f 66 20 74 68 | 65 20 62 75 69 6c 74 2d |ts of th|e built-|
|000000f0| 69 6e 20 5c 64 66 6e 7b | 64 69 63 74 69 6f 6e 61 |in \dfn{|dictiona|
|00000100| 72 79 7d 20 74 79 70 65 | 2c 0d 65 78 63 65 70 74 |ry} type|,.except|
|00000110| 20 74 68 61 74 20 6b 65 | 79 73 20 61 6e 64 20 76 | that ke|ys and v|
|00000120| 61 6c 75 65 73 20 61 72 | 65 20 61 6c 77 61 79 73 |alues ar|e always|
|00000130| 20 73 74 72 69 6e 67 73 | 2c 20 61 6e 64 20 70 72 | strings|, and pr|
|00000140| 69 6e 74 69 6e 67 20 61 | 20 64 62 6d 0d 6f 62 6a |inting a| dbm.obj|
|00000150| 65 63 74 20 64 6f 65 73 | 6e 27 74 20 70 72 69 6e |ect does|n't prin|
|00000160| 74 20 74 68 65 20 6b 65 | 79 73 20 61 6e 64 20 76 |t the ke|ys and v|
|00000170| 61 6c 75 65 73 2e 0d 0d | 54 68 65 20 6d 6f 64 75 |alues...|The modu|
|00000180| 6c 65 20 64 65 66 69 6e | 65 73 20 74 68 65 20 66 |le defin|es the f|
|00000190| 6f 6c 6c 6f 77 69 6e 67 | 20 63 6f 6e 73 74 61 6e |ollowing| constan|
|000001a0| 74 20 61 6e 64 20 66 75 | 6e 63 74 69 6f 6e 73 3a |t and fu|nctions:|
|000001b0| 0d 0d 5c 72 65 6e 65 77 | 63 6f 6d 6d 61 6e 64 7b |..\renew|command{|
|000001c0| 5c 69 6e 64 65 78 73 75 | 62 69 74 65 6d 7d 7b 28 |\indexsu|bitem}{(|
|000001d0| 69 6e 20 6d 6f 64 75 6c | 65 20 64 62 6d 29 7d 0d |in modul|e dbm)}.|
|000001e0| 5c 62 65 67 69 6e 7b 65 | 78 63 64 65 73 63 7d 7b |\begin{e|xcdesc}{|
|000001f0| 65 72 72 6f 72 7d 0d 52 | 61 69 73 65 64 20 6f 6e |error}.R|aised on|
|00000200| 20 64 62 6d 2d 73 70 65 | 63 69 66 69 63 20 65 72 | dbm-spe|cific er|
|00000210| 72 6f 72 73 2c 20 73 75 | 63 68 20 61 73 20 49 2f |rors, su|ch as I/|
|00000220| 4f 20 65 72 72 6f 72 73 | 2e 20 5c 63 6f 64 65 7b |O errors|. \code{|
|00000230| 4b 65 79 45 72 72 6f 72 | 7d 20 69 73 0d 72 61 69 |KeyError|} is.rai|
|00000240| 73 65 64 20 66 6f 72 20 | 67 65 6e 65 72 61 6c 20 |sed for |general |
|00000250| 6d 61 70 70 69 6e 67 20 | 65 72 72 6f 72 73 20 6c |mapping |errors l|
|00000260| 69 6b 65 20 73 70 65 63 | 69 66 79 69 6e 67 20 61 |ike spec|ifying a|
|00000270| 6e 20 69 6e 63 6f 72 72 | 65 63 74 20 6b 65 79 2e |n incorr|ect key.|
|00000280| 0d 5c 65 6e 64 7b 65 78 | 63 64 65 73 63 7d 0d 0d |.\end{ex|cdesc}..|
|00000290| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000002a0| 7b 6f 70 65 6e 7d 7b 66 | 69 6c 65 6e 61 6d 65 5c |{open}{f|ilename\|
|000002b0| 2c 20 72 77 6d 6f 64 65 | 5c 2c 20 66 69 6c 65 6d |, rwmode|\, filem|
|000002c0| 6f 64 65 7d 0d 4f 70 65 | 6e 20 61 20 64 62 6d 20 |ode}.Ope|n a dbm |
|000002d0| 64 61 74 61 62 61 73 65 | 20 61 6e 64 20 72 65 74 |database| and ret|
|000002e0| 75 72 6e 20 61 20 6d 61 | 70 70 69 6e 67 20 6f 62 |urn a ma|pping ob|
|000002f0| 6a 65 63 74 2e 20 20 5c | 76 61 72 7b 66 69 6c 65 |ject.  \|var{file|
|00000300| 6e 61 6d 65 7d 20 69 73 | 0d 74 68 65 20 6e 61 6d |name} is|.the nam|
|00000310| 65 20 6f 66 20 74 68 65 | 20 64 61 74 61 62 61 73 |e of the| databas|
|00000320| 65 20 66 69 6c 65 20 28 | 77 69 74 68 6f 75 74 20 |e file (|without |
|00000330| 74 68 65 20 5c 66 69 6c | 65 7b 2e 64 69 72 7d 20 |the \fil|e{.dir} |
|00000340| 6f 72 20 5c 66 69 6c 65 | 7b 2e 70 61 67 7d 0d 65 |or \file|{.pag}.e|
|00000350| 78 74 65 6e 73 69 6f 6e | 73 29 2c 20 5c 76 61 72 |xtension|s), \var|
|00000360| 7b 72 77 6d 6f 64 65 7d | 20 69 73 20 5c 63 6f 64 |{rwmode}| is \cod|
|00000370| 65 7b 27 72 27 7d 2c 20 | 5c 63 6f 64 65 7b 27 77 |e{'r'}, |\code{'w|
|00000380| 27 7d 20 6f 72 20 5c 63 | 6f 64 65 7b 27 72 77 27 |'} or \c|ode{'rw'|
|00000390| 7d 20 61 73 20 66 6f 72 | 0d 5c 63 6f 64 65 7b 6f |} as for|.\code{o|
|000003a0| 70 65 6e 7d 2c 20 61 6e | 64 20 5c 76 61 72 7b 66 |pen}, an|d \var{f|
|000003b0| 69 6c 65 6d 6f 64 65 7d | 20 69 73 20 74 68 65 20 |ilemode}| is the |
|000003c0| 75 6e 69 78 20 6d 6f 64 | 65 20 6f 66 20 74 68 65 |unix mod|e of the|
|000003d0| 20 66 69 6c 65 2c 20 75 | 73 65 64 20 6f 6e 6c 79 | file, u|sed only|
|000003e0| 0d 77 68 65 6e 20 74 68 | 65 20 64 61 74 61 62 61 |.when th|e databa|
|000003f0| 73 65 20 68 61 73 20 74 | 6f 20 62 65 20 63 72 65 |se has t|o be cre|
|00000400| 61 74 65 64 2e 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |ated..\e|nd{funcd|
|00000410| 65 73 63 7d 0d          |                         |esc}.   |        |
+--------+-------------------------+-------------------------+--------+--------+